home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / dev / lang / HeliOS4.lha / helios_demo_disk4 / docs / userinterface / OutputBuffering.doc < prev    next >
Encoding:
Text File  |  1994-11-10  |  3.8 KB  |  96 lines
  1. *********************
  2. Output text buffering
  3. *********************
  4.  
  5. HeliOS allows all text output to the main interpreter window to be sent
  6. additionally to an editable output buffer.
  7.  
  8. The output buffer is accessed normally via the "Out" editor, which is
  9. a fully functional HeliOS editor with all normal editing functions such
  10. as Load, Save, Cut/Copy/Paste, Print etc..
  11.  
  12. The "Out" editor normally acts as an editable interpreter "capture" buffer.
  13.  
  14. ********************************
  15. 3(+1) Source/Compilation Editors
  16. ********************************
  17.  
  18. In functional terms you actually have three "normal" separate main editors,
  19. plus another identical editor to which interpreter output is routed.
  20.  
  21. The interpreter and editor screens have buttons labelled "Ed 1", "Ed 2",
  22. "Ed 3" and "Out" which highlight to indicate the current editor(s) in use.
  23.  
  24. The "Out" editor can be used as a fourth "normal" editor if you like, by
  25. switching off the "Output buffer" from the Interpreter menus.
  26.  
  27. The "Out" editor button has a small red highlight to indicate that it is
  28. currently in "Output buffer" mode with text currently being captured.
  29.  
  30. ****************
  31. The "Out" buffer
  32. ****************
  33.  
  34. The default option is to send all interpreter and/or program output text
  35. to the "Output" uffer as well as to screen.  This function can be disabled
  36. and saved as a default startup user-option.
  37.  
  38. The output buffer is fully editable, as already mentioned, and has its own
  39. editor button: you can regard interpreter output as going straight into
  40. the buffer of "Editor 4", where you can edit it exactly like any file.
  41.  
  42. Remember that the "Out" editor is absolutely identical to the other Editors,
  43. and if you wish, you can at any time switch off the interpreter output to
  44. "Out" and simple use it as an extra editor for source code editing.
  45.  
  46. The output buffer can be resized and cleared as required using Interpreter
  47. menu options.
  48.  
  49. If the buffer becomes full during program execution you are given an option
  50. to increase the buffer size.  If you do not increase the size you will lose
  51. the earliest information as the buffer fills, and in general the buffer will
  52. behave as a first-in-first-out text store.  In any single program execution
  53. if you are asked whether you wish to resize the buffer and say "no", the
  54. buffer will be treated as first-in-first-out for the rest of that execution
  55. session.  In other words, once you have refused to enlarge the buffer you
  56. will not be asked again during that particular program execution.
  57.  
  58. The output buffer can be cleared or resized at any time using an option
  59. in the Interpreter menu.
  60.  
  61. ***************
  62. Session Markers
  63. ***************
  64.  
  65. The Interpreter Output can (optionally) include "Session Markers".
  66.  
  67. These "markers" include session numbers, time log comments, actual program
  68. execution time information, and stack content displays.
  69.  
  70. The accuracy of the elapsed time display is only within 1 second, since
  71. the session startup and end display code introduces sufficient variable
  72. delay to make finer timing meaningless.  If you want to do accurate time
  73. checks on your code you will need to use several iterations of a program
  74. within one output session to improve accuracy.
  75.  
  76. The markers basically divide up and label each interpreter operation, so
  77. that when you are scrolling through the output buffer you can see exactly
  78. what happened and when it happened quite easily.
  79.  
  80. There are menu options for switching these markers and all the associated
  81. information displays on and off, although you will generally find it most
  82. worthwhile to retain them.
  83.  
  84. The "session log" numbering can be reset at any time using an Interpreter
  85. menu option.
  86.  
  87.  
  88. *****************
  89. Output separators
  90. *****************
  91.  
  92. Output can optionally have separator lines between each interpreter session.
  93.  
  94. These are mainly a visual aid to help identify easily the start and end
  95. of each session and can be switched on or off as desired.
  96.